home *** CD-ROM | disk | FTP | other *** search
/ Computer Life: SuperPac / SuperPac (Computer Life Magazine)(Ziff-Davis)(1995).ISO / pc / demos / tracker / disk1 / script.do_ / script.do
Encoding:
Text File  |  1995-03-29  |  3.4 KB  |  91 lines
  1.                      SCRIPTING LANGUAGE DOCUMENTATION
  2.  
  3.  
  4. This file documents the scripting language supported by AT&T Mail Access PLUS
  5. and AT&T Mail Access PLUS for Windows.
  6.  
  7. Each line in a script file represents a command to be executed by the AT&T
  8. Background Mailer (BGMAIL), Access,  or the Online application of Access PLUS
  9. for Windows.  The syntax and meaning of each command is as follows:
  10.  
  11. BREAK [<h-seconds>]                   Send a BREAK signal for a <h-seconds>
  12.                     hundreths of a second duration.  The
  13.                     default without optional argument is
  14.                     12/100 or .12 of a second (e.g.
  15.                     BREAK 12)
  16.  
  17. DELAY <#-seconds>              Delay script execution for <#-seconds>
  18.                     seconds.
  19.  
  20. DISPLAY "<string>"                    Display <string> on BGMAIL status line
  21.                     or in Background Mailer Status window.
  22.                     Quotes are required but not displayed.
  23.  
  24. DO <script-file>                    Continue script execution using script
  25.                     commands in the file <script-file>.
  26.                     The file must reside in the Access
  27.                     PLUS program directory.  Execution
  28.                     does not return to the calling script.
  29.  
  30. DTR { ON | OFF }              Toggle COM port DTR state on or off.
  31.  
  32. ECHO { ON | OFF }                     Echo SEND/WAIT strings.  Obsolete and
  33.                     does nothing currently.
  34.  
  35. IFGOT { 1 | 2 | 3 } SKIP <#-lines>        Transfer control <#-lines> down if
  36.                     WAIT parameter <string-1>, <string-2>,
  37.                     or <string-3> was received.  Used after
  38.                     a WAIT command. Comments lines do not
  39.                     count.
  40.  
  41. IFONLINE SKIP <#-lines1> OR <#-lines2>  Used for conditional control for a user
  42.                     who goes Online and uses Information
  43.                     Services menu.  Pressing 1 <CR> (for
  44.                     AT&T Mail) will skip <#-lines2> lines
  45.                     down.  Pressing anything else will skip 
  46.                     <#-lines1> lines down.  See LOGON.SCR
  47.                     for example.
  48.  
  49. RESET                      Reset an internal Hayes Smartmodem, if
  50.                     installed, along with the COM port
  51.                     hardware.
  52.  
  53. SEND <#-seconds> "<string>"            Send <string> with <#-seconds> second
  54.                         delay before every character is sent.
  55.                     Use 0 for <#-seconds> for no delay.
  56.                     Quotes are required but not sent.
  57.  
  58. SKIP <#-lines>                Transfer control <#-lines> down
  59.                           unconditionally.  Comments lines do
  60.                     not count.
  61.  
  62. WAIT <#-seconds> "<string-1>"        Wait for <string-1>, <string2>, or
  63.             [ OR "<string-2>"        <string-3> no longer than <#-seconds>.
  64.         [ OR "<string-3>" ] ]    Use IFGOT to test which string was
  65.                     received.  Quotes are required but not
  66.                     part of the strings.
  67.  
  68. *[<text>]                  Comment line.  Must start in column 1.
  69.                     Not counted by SKIPs.
  70.  
  71.  
  72. NOTE: <#-seconds> above can be specified in whole seconds (for example, 1, 20,
  73.       or 90), in tenths or hundredths (for example, .5, 0.1, or .12), or mixed
  74.       (for example, 1.5 or 6.25).
  75.  
  76. Several character sequences have special meaning in a SEND, WAIT, or DISPLAY
  77. command string parameter and are replaced with values as follows:
  78.  
  79.      $A, $B, $C        User-defined parameters #1, #2, and #3 from
  80.             configuration, respectively.
  81.      $L             Login name from configuration.
  82.      $M             Mail service password from configuration.
  83.      $N             Dial prefix, if defined, and dial number from
  84.             configuration.
  85.      $P             Password from configuration.
  86.      $S            Replaced with the  string "AT&T Mail" (without quotes).
  87.      $$            Replaced by a single $ character.
  88.  
  89.      ^X             ASCII Control X character (where 'X' can be from A to Z)
  90.             For example, ^M = ASCII 13 = Carriage Return
  91.